home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tools / packer / wbsplitter / wbsplitter.dok < prev    next >
Text File  |  1992-10-22  |  17KB  |  429 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                               (WB)FileSplitter V 1.2
  12.                               ----------------------
  13.  
  14.                         Programmierung, Konzept, Idee: MMR
  15.  
  16.                                   © 1992 BY MMR ©
  17.  
  18.  
  19.                         Nur fuer Kick 2.0 (V37.) aufwaerts
  20.                         **********************************
  21.                                     >Freeware<
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31. Inhalt:
  32. -------
  33.    1.   FileSplitter         ---> WB-CLI Version
  34.    2.   FileSplitter.info    ---> Sehr wichtig fuer Gundeinstellung
  35.    3.   FileSplitter.dok     ---> Dies File hier....
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44. Allgemeines
  45. -----------
  46.  
  47. Mit dem FileSplitter ist es moeglich, sich ein File oder mehrere Files aus
  48. einem [.lha/.lzh] File zu entpacken.
  49. Desweiteren ist es auch moeglich Files und Directorys zu selektieren und
  50. diese zu packen, als extra File.lha oder an ein File anzuhaengen.
  51.  
  52. Warum denn sowas?
  53. Vielleicht moechte man sich nur mal das Doc.File oder Programmfile aus einem
  54. Paket entpacken lassen, und wenn das Paket 600 KB gross ist (und man kein
  55. Besitzer einer Turbokarte ist), kann das ganz schoen nerven bis das Paket
  56. entpackt ist, evtl. hat man auch zu wenig Speicher um das ganze Paket ins
  57. RAM: zu entpacken, usw....
  58. Mittlerweile bin ich bei der Version 1.2 angelangt, mit dieser ist es nun
  59. auch moeglich File(s) oder Directorys zu packen, also ist der FileSplitter
  60. schon sowas wie eine Benutzeroberflaeche fuer den LHA.
  61.  
  62.  
  63. Installation
  64. ------------
  65.     CLI:  Einfach FileSplitter eingeben und Return druecken.
  66.  
  67.           Beim CLI-Start werden keine Eingabeparameter erwartet, d.h.
  68.           der FileSplitter benutzt seine internen Werte, also die
  69.           die Defaultwerte, diese koennen aber jederzeit geaendert werden!
  70.           Als da waeren:
  71.  
  72.  
  73.               GADGETS             Einstellung
  74.               -------             -----------
  75.  
  76.           1.  Showlist           aktiviert
  77.           2.  Showextract        aktiviert
  78.           3.  Suchpfad           Default Pfad   SYS:
  79.           4.  Packerpfad         Default Packer c:LHA
  80.           5.  Optionen                  ----
  81.           5.1 |-- Listwindow     Default CON:10/30/620/200/Listoutput
  82.           5.2 |-- Extractwindow  Default CON:10/30/620/200/Extractoutput
  83.           5.3 |-- Entpackoption  Default e
  84.           5.4 |-- Packoption     Default -w -x a
  85.           6.  Zielpfad           Default Pfad   RAM:
  86.           7.  Windowdelay        Default 2 Sekunden
  87.  
  88.  
  89.      WB:  Einfach auf das Icon doppelklicken
  90.  
  91. WICHTIG:  Das Icon enthaelt wichtige >Tooltype< Eintraege,also
  92.           einmal anklicken, dann in der Menueleiste >Piktogramm/Information
  93.           oder mit R-AMIGA-I, das Tooltypearray editieren!
  94.  
  95.  
  96.           1. SHOWLIST=        YES/NO
  97.           2. SHOWEXTRACT=     YES/NO
  98.           3. LISTWINDOW=      Definiert das Listwindow
  99.           4. EXTRACTWINDOW=   Definiert das Extrackt/Packwindow
  100.           5. ZIELPFAD=        Das Destination Directory
  101.           6. PACKERPFAD=      Den Pfad und Packer
  102.           7. SUCHPFAD=        Das Directory zum LHA Files einlesen
  103.           8. ENTPACKOPTION=   Die Optionen des LHA zum entpacken
  104.           9. PACKOPTION=      Die Optionen des LHA zum packen
  105.          10. WINDOWDELAY=     Zeit die verstreicht bis das window schliesst
  106.  
  107.  
  108.           Diese Einstellungen werden dann vom FileSplitter uebernommen.
  109.           -------------------------------------------------------------
  110.  
  111. Arraytypen: SHOWLIST=YES/NO        ....listet das .lha File in einem Shell
  112.                                        Window auf, eigendlich nur wichtig
  113.                                        um festzustellen ob das File ok ist.
  114.                                      * siehe auch WINDOWDELAY, LISTWINDOW
  115.  
  116.  
  117.             SHOWEXTRACT=YES/NO     ....listet das selektierte File in einem
  118.                                        Shell-Window auf, auch nur wichtig
  119.                                        um festzustellen ob das File ok ist.
  120.                                      * siehe auch WINDOWDELAY, EXTRACTWINDOW
  121.  
  122.  
  123.             LISTWINDOW=CON:10/30/620/200/Listoutput
  124.                                    ....hier koennen die Shell-Window
  125.                                        groessenangaben eingestellt werden,
  126.                                        Diese Optionen werden genauso wie
  127.                                        im CLI erwartet
  128.                                      * siehe auch SHOWLIST, WINDOWDELAY
  129.  
  130.  
  131.             EXTRACTWINDOW=CON:10/30/620/200/Extractoutput
  132.                                    ....hier koennen die Shell-Window
  133.                                        groessenangaben eingestellt werden,
  134.                                        Diese Optionen werden genauso wie
  135.                                        im CLI erwartet
  136.                                      * siehe auch SHOWEXTRACT, WINDOWDELAY
  137.  
  138.  
  139.                    Die Parameter werden genauso wie im CLI erwartet
  140.  
  141.             also:  CON:10/30/620/200/Windowname
  142.                     |  |  |  |   |   |_____________Titel des Fensters
  143.                     |  |  |  |   |_________________Hoehe in Bildpunkten
  144.                     |  |  |  |_____________________Breite in Bildpunkten
  145.                     |  |  |________________________Y-Startpunkt des Fensters
  146.                     |  |___________________________X-Startpunkt des Fensters
  147.                     |______________________________Device
  148.  
  149.  
  150.             ZIELPFAD=RAM:          ....hier kann der Pfad des entpackten
  151.                                        Files.lha eingestellt werden, z.B.:
  152.                                        DF0:, DH0:Tools usw.
  153.  
  154.  
  155.             SUCHPFAD=DH1:Download  ....hier kann das Directory eingestellt
  156.                                        werden, in dem man die .lha Files
  157.                                        liegen hat.
  158.  
  159.  
  160.             PACKERPFAD=C:LHA       ....hier wird der Pfad und der Packer
  161.                                        eingestellt.
  162.  
  163.  
  164.             ENTPACKOPTION=e        ....hier die Option (e) entpacken
  165.  
  166.  
  167.             PACKOPTION=-w -x a     ....hier -w = set Workdirectory, sehr
  168.                                        wichtig damit nur die selektierten
  169.                                        File und Diectorys gepack werden und
  170.                                        nicht der komplette Pfad ab dem
  171.                                        Devicenamen.
  172.                                        -x = Use Pathnames
  173.                                        a = add also packen
  174.  
  175.  
  176.             WINDOWDELAY=2          ....Die Wartezeit bis das Shell-Window
  177.                        (0)             wieder geschlossen wird.
  178.                                        Wird der Wert 0 eingegeben, erscheint
  179.                                        im EXTRACT/LISTWINDOW der Text
  180.                                        "Press RETURN..."
  181.                                        Das Window bleibt solange geoeffnet
  182.                                        bis mit RETURN bestaetigt wird!!
  183.  
  184.  
  185.  
  186.  
  187. Benutzung
  188. ---------
  189.                                   FEHLER
  190.                                 **********
  191.  
  192. Sollte etwas mit den Optionen nicht stimmen, z.B. ein Zeichen vergessen,
  193. Windowgroesse stimmt nicht, falscher Pfad, wird dieses mit einem aufblitzen
  194. des Screen angedeutet.                                           ^^^^^^^^^^
  195.  
  196. Um an die Default-Einstellungen zu gelangen, braucht man nur einmal CANCEL
  197. im Requester (fuer alle Optionen, Zielpfad, Packerpfad, Suchpfad)   ^^^^^^
  198. bestaetigen, und die Standartoptionen werden uebernommen.........
  199. Diese Optionen waeren dann mit den der CLI-Eingabe identisch!
  200.  
  201. ****************************************************************************
  202. *                                                                          *
  203. *                                 ACHTUNG                                  *
  204. *    Der Requester der beim Filepacken erscheint (MULTISELECT-REQUESTER)   *
  205. *    hat beim testen des Programms ab und an den Task ausgebremst, wenn    *
  206. *    ich das mal so ausdruecken darf, es passiert nichts weiter, nur das   *
  207. *    Directory einlesen dauer etwas (extrem) laenger.                      *
  208. *                                                                          *
  209. *    DIES IST EIN FEHLER IN DER REQTOOL.LIBRARY                            *
  210. *                                                                          *
  211. ****************************************************************************
  212.  
  213.  
  214. Nach dem starten...
  215. -------------------
  216.  
  217. Taste=R-AMIGA-Q oder das Closewindow-Gadget
  218. -------------------------------------------
  219.  
  220.    Hiermit wird das Programm beendet, bzw. auch mit dem Menueeintrag QUIT.
  221.  
  222.  
  223. Show List und Show Extract
  224. --------------------------
  225.  
  226.    Die Gadgets Show List und Show Extract sind zum ueberpruefen des Files
  227.    gedacht, z.B. kann das File ein CRC-Error haben, und dieses merkt man nur
  228.    an dem Output des Packers und dem Returncode und evtl. gefolgt von einem
  229.    aufblitzen des Screen......
  230.  
  231.  
  232. Taste=SPACE oder das Cycel-Gadget
  233. ---------------------------------
  234.  
  235.    Das Cycel-Gadget beinhaltet drei Moeglichkeiten:
  236.  
  237.     1.  Information         ...kleines Info
  238.     2.  File entpacken      ...das .lha File anwaehlen
  239.     3.  File(s) packen      ...Files und Directorys packen
  240.     4.  Palette             ...Farben aendern
  241.  
  242.    Diese Funktionen koennen auch mit der SPACE-TASTE durchgeblaettert werden
  243.    Zu aktivieren sind diese dann mit dem Starten-Gadget, oder R-AMIGA-S
  244.  
  245.  
  246. Taste=R-AMIGA-S oder das Starten-Gadget
  247. ---------------------------------------
  248.  
  249.    Mit diesem Gadget werden die Aktionen ausgefuehrt die im Cycel-Gadget
  250.    selektiert wurden.
  251.  
  252.  
  253. Taste=R-AMIGA-P oder das Packerpfad-Gadget
  254. ------------------------------------------
  255.  
  256.    Hier wird der Packer gewaehlt, z.B. LHA oder LZ.
  257.    Wird im Requester CANCEL gewaehlt, wird der Defaultwert c:LHA uebernommen.
  258.  
  259.  
  260. Taste=R-AMIGA-Z oder das Zielpfad-Gadget
  261. ----------------------------------------
  262.  
  263.    Hier wird der Zielpfad (Greraet/Directory) angewaehlt, z.B. RAM:, DH0:Tool
  264.    Wird im Requester CANCEL gewaehlt, wird der Dafaultwert RAM: uebernommen.
  265.  
  266.  
  267. Taste=R-AMIGA-O oder das Optionen-Gadget
  268. ----------------------------------------
  269.  
  270.    Es erscheint ein neues Window, indem die Pack, Listwindow und
  271.    Extractwindow Optionen eingestellt werden koennen.
  272.    Das Eingabeformat etspricht dem des Tooltypearrays, bitte dort nachlesen!
  273.    Wird im Requester CANCEL gewaehlt, wird der Defaultwert fuer:
  274.  
  275.    1.         Listwindow: CON:10/30/620/200/Listoutput
  276.  
  277.    2.      Extractwindow: CON:10/30/620/200/Extractoutput
  278.  
  279.    3.       Packeroption: e
  280.  
  281.    4.      Entpackoption: -w -x a
  282.    uebernommen.
  283.  
  284.  
  285.  
  286.                               Los gehts
  287.                              ***********
  288.  
  289.  
  290. Also dann, Files entpacken:
  291. ---------------------------
  292.  
  293. Das Cycelgadget auf File entpacken stellen und einmal auf das
  294. Startengadget klicken. Es erscheint ein Filerequester in dem das File
  295. angewaehlt werden kann. Sollte das Gadget Show List aktiv sein, wird ein
  296. Listing ausgegeben.
  297. Sollte alles richtig eingestellt sein erscheinen 5 neue Gadgets.
  298. Nun erscheint eine Liste der Files aus dem .lha Paket, diese brauchen
  299. einfach nur einmal angeklickt zu werden! Sollte das Gadget Show Extract aktiv
  300. sein, wird das entpacken in einem Shell-Window angezeigt.
  301. Nach dem entpacken wird das selektierte File aus der Liste geloescht!
  302.  
  303. Wird das Multi-Wahl Gadget einmal angeklickt (dadurch wird das Multi-Doit
  304. Gadget waehlbar), kann ab sofort in das Listwindow geklickt werden ohne das
  305. die Files sofort ertpackt werden. Erst nach bestaetigen des Multi-Doit
  306. Gadgets werden die selektierten Files entpackt, oder aber es wurde das
  307. letzte File in der Liste angeklickt, dann wird automatisch entpackt.
  308.  
  309. Um die Multi-wahl Funktion wieder abzuschalten, genuegt es einmal auf das
  310. Multi-Doit Gadget zu klicken, aber nur wenn noch kein File selektiert worden
  311. ist, wurden Files selektiert, werden dieses erst entpackt!
  312.  
  313. Das Nix mehr Gadget bricht alles ab und fuehrt wierder zum Hauptmenue.
  314. Das New File Gadget bricht alles ab und fuehrt sofort wieder in den
  315. Fileauswahl Requester um ein neues File zu selektieren.
  316. Sollte das Multi-Wahl Gadget gerade aktiv sein und es wurden Files
  317. selektiert, werden dies ignoriert!!
  318.  
  319.  
  320.  
  321. Taste=R-AMIGA-N oder das Nix mehr-Gadget
  322. ----------------------------------------
  323.  
  324.    Hiermit gelangt man wieder in den Anfangszustand des Programms um evtl. ein
  325.    neues File zu laden, oder die Optionen aendern zu koennen.
  326.  
  327.  
  328. Taste=R-AMIGA-F oder das New File-Gadget
  329. ----------------------------------------
  330.  
  331.    Hiermit gelangt man sofort in den Filerequester, um ein neues File
  332.    einzulesen! Die durch Multi-Wahl selektierten Files werden nicht mehr
  333.    entpackt.
  334.  
  335.  
  336. Taste=R-AMIGA-M oder das Multi-Wahl-Gadget
  337. ------------------------------------------
  338.  
  339.    Dieses Gadget wird nach dem anklicken inaktiv und das Multi-Doit Gadget
  340.    aktiv. Dies bedeutet, das alles jetzt angeklickten Files gepuffert werden
  341.    und erst dann entpackt werden wenn das Multi-Doit Gadget angeklickt wird,
  342.    oder das letze File in der Liste selektiert wurden ist.
  343.    Wurde kein File selektiert und man klickt in das Multi-Doit Gadget, blitz
  344.    der Screen einmal, und man gelang wieder in den Entpackmodus einzelner
  345.    Files.
  346.  
  347.  
  348. Taste=R-AMIGA-D oder das Multi-Doit-Gadget
  349. ------------------------------------------
  350.  
  351.    Diese Gadget ist nur aktiv wenn das Multi-Wahl Gadget aktiviert worden
  352.    ist. Hiermit werden die selektierten Files dann entpackt.
  353.    Sollten noch Files in der Liste vorhanden sein die nicht selektiert
  354.    wurden, werden diese wieder angezeigt.
  355.  
  356.  
  357. File(s) packen:
  358. ---------------
  359.  
  360. Das Cycelgadget auf File(s) packen stellen, und einmal das Startengadget
  361. anklicken. Es erscheint nun ein MULTISELECT-REQUESTER, das heisst, um
  362. mehrere Files oder auch Directorys zu selektieren haelt man einfach die
  363. SCHIFT-TASTE gedrueckt und klickt das File oder Directory EINMAL an.
  364. Ich hoffe das mit dem Requester jeder vertraut ist, er bietet wirklich sehr
  365. viel Optionen.
  366. Gut, nach dem selektieren erscheinen wieder 4 neue Gadget und ein Listgadget!
  367. In diesem werden jetzt alle selektierten Files und Directory angezeigt.
  368. Mit Abbruch wird sofort wieder zum Startmenu gesprungen.
  369. Ein Klick auf das Remove Gadget aktiviert dieses, dadurch werden die anderen
  370. Gadget inaktiv, ein nochmaliger Klick auf das Remove Gadget schaltet die
  371. Remove Funktion wieder ab, dadurch werden die anderen Gadget wieder aktiv.
  372. Bei aktivem Remove kann jetzt in die Liste geklickt werden um Files oder
  373. Directorys zu loeschen, falls man diese doch nicht packen moechte!
  374. Bei Nichtaktivem Remove kann jetzt einfach in die Liste geklickt werden und
  375. diese File oder Directory wird dann gepack, in diesem Moment erscheint ein
  376. neuer Requester in dem man den Pfad und Filenamen angeben kann.
  377. Ein Klick auf das Packen Gadget packt alle Files und Directorys in der List
  378. und spring dann in das Startmenu zurueck. Auch hier wird nach dem Pfad und
  379. Filenamen durch ein Requester gefragt, sollte dies nicht vorher schon
  380. geschehen sein.
  381. Ein Klick auf das File dazu Gadget packt alles Files oder Directorys in der
  382. Liste, sollte noch kein Filename existieren wird auch diese per Requester
  383. erfragt. Danach wird sofort wieder der MULTISELECT-REQUESTER aufgerufen um
  384. neue Files oder Directorys zu selektieren. Doch bei diesem Gadget wird
  385. spaeter nicht mehr nach dem Pfad und Filenamen fuer das Packfile gefragt,
  386. also werden die Daten an das bestehende File.lha angehaent.
  387.  
  388.  
  389. Taste=R-AMIGA-A oder das Abbruch-Gadget
  390. ---------------------------------------
  391.  
  392.    Dieses Gadget bricht alles ab und springt in das Startmenu.
  393.  
  394.  
  395. Taste=R-AMIGA-P oder das Packen-Gadget
  396. --------------------------------------
  397.  
  398.    Hiermit werden die Files oder Directorys in der Liste gepackt, es wird
  399.    mit einem Requester der Pfad und Filename erfragt, danach gelangt man
  400.    wieder in das Startmenu
  401.  
  402.  
  403. Taste=R-AMIGA-R oder das Remove-Gadget
  404. --------------------------------------
  405.  
  406.    Wird in dieses Gadget geklickt, aktiv wenn die anderen Gadgets
  407.    inaktiv sind, kann ein File oder Directory aus der Liste geloescht werden
  408.    indem man das File oder Directory anklickt.
  409.    Ein nochmaliger Klick in das Remove Gadget hebt diese Funktion wieder
  410.    auf, erkenntlich an den anderen aktiven Gadgets. Ab jetzt kann wieder ein
  411.    einzelnes File oder Directory gepackt werden indem man es einfach in der
  412.    Liste anklickt.
  413.  
  414.  
  415. Taste=R-AMIGA-F oder das New File-Gadget
  416. ----------------------------------------
  417.  
  418.    Wird dieses Gadget angeklickt, werden die Eintraege der Liste gepackt und
  419.    danach erscheint der MULTISELECT-REQUESTER um neue Files zu selektieren, die
  420.    dann wieder an das bestehende File.lha gepackt werden.
  421.  
  422.  
  423. Hmm, das waere dann schon das Groebste, denk ich.
  424.  
  425.  
  426.  
  427. MMR.........(Barney)
  428.  
  429.